home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / tcl / tclx7.5a- / tclx7 / README < prev   
Encoding:
Text File  |  1995-11-14  |  8.3 KB  |  241 lines
  1.                            Extended Tcl (TclX) 7.5a
  2.                            ========================
  3.  
  4. TclX 7.5 Alpha 2 Release
  5. ========================
  6.  
  7. This is the second TclX alpha release that is compatible with the Tcl 7.5 /
  8. Tk 4.1 alpha line.  Its is known to work with the Tcl/Tk alpha 2 releases.
  9. This only consists of a few bug fixes, but they where annoying people.
  10.  
  11. This release contains mainly changes for compatibility with Tcl 7.5.  Shared
  12. libraries are not currently built, so its not dynamically loadable out of the
  13. box.  Eventually, this will be supported.
  14.  
  15. No support is currently available for MS Windows or the MacIntosh.  We
  16. are interested in supporting these platforms, but don't have the time
  17. or expertise to do it in the near future.  If anyone is interested in
  18. working with us on these port, we would like to do it in the same manner
  19. as Tcl and Tk.  Please contact us if you would like to help.  We are
  20. interested in having two independent (from each other), experienced developers
  21. for each platform.  We will handle merge changes into the source tree and
  22. making changes available.  Please contact us at tcl-project@neosoft.com
  23. if you think you can help.
  24.  
  25.  
  26.  
  27. INTRODUCTION
  28. ============
  29.  
  30.     Extended Tcl (TclX), is a set of extensions to Tcl 7.5, the Tool Command
  31. Language invented by Dr. John Ousterhout of the University of California at
  32. Berkeley.  Tcl is a powerful, yet simple embeddable programming language.
  33. Extended Tcl is oriented towards Unix system programming tasks and large
  34. application development.  Many additional interfaces to the Unix operating
  35. system are provided.  It is upwardly compatible with Tcl 7.5.  You take the
  36. Extended Tcl package, add it to Tcl 7.5, and from that you get Extended Tcl.
  37. (Berkeley Tcl is not included in this distribution, obtain it from
  38. ftp.cs.berkeley.edu).
  39.  
  40.    Support is also included for building a Tk 4.0 wish shell (wishx)
  41. with the Extended Tcl command set.
  42.  
  43.    While this TclX distribution is tested with Tcl 7.5 and Tk 4.0, it will
  44. probably work with new versions of Tcl & Tk with little or no changes.
  45.  
  46.    Extended Tcl was designed and implemented by Karl Lehenbauer
  47. (karl@NeoSoft.com) and Mark Diekhans (markd@Grizzly.com), with help
  48. in the early stages from Peter da Silva (peter@NeoSoft.com).
  49.  
  50.    As with Berkeley Tcl, all of Extended Tcl is freely
  51. redistributable, including for commercial use and resale.
  52.  
  53.    Please read the file INSTALL carefully before building and
  54. installing Extended Tcl.
  55.  
  56. NEW FEATURES IN TCLX 7.5a
  57. =========================
  58.  
  59.   o Compatibility with Tcl 7.5 / Tk 4.1 alpha.
  60.  
  61. FEATURES ADDED BY EXTENDED TCL
  62. ==============================
  63.  
  64.    Here is a summary of the features added by Extended Tcl.  For
  65. more details on the commands and functionality provided by Extended
  66. Tcl, see the manual page man/TclX.man.
  67.  
  68.     o A shell, which provides an environment for developing and
  69.       executing Tcl programs.
  70.  
  71.     o Advanced Tcl code library facility that is oriented towards building
  72.       large applications.  It is compatible with standard Tcl auto-loading.
  73.  
  74.     o General purpose commands which define new programming
  75.       constructs,  debugging and profiling facilities.
  76.  
  77.     o Unix access commands provide access to many Unix system calls,
  78.       including process management.
  79.  
  80.     o File I/O commands provide added facilities for accessing and
  81.       manipulating open files.
  82.  
  83.     o File scanning facility that provides awk-like functionality.
  84.  
  85.     o Extended list manipulation commands.
  86.  
  87.     o Keyed lists, a type of list that provides functionality
  88.       similar to C structures.
  89.  
  90.     o Extended string and character manipulation commands.
  91.  
  92.     o Time and date manipulation and conversion commands.
  93.  
  94.     o Online help on Tcl, TclX and Tk commands.
  95.  
  96.     o A simple interface for accessing and building TCP/IP based servers.
  97.  
  98.     o X/PG based internationalization commands.
  99.  
  100. ON-LINE HELP
  101. ============
  102.  
  103.     There is a help system included with Extended Tcl.  It contains
  104. some documentation on every command in Berkeley Tcl, Extended Tcl
  105. and Tk.  You can invoke it interactively from within Extended Tcl by
  106. typing "help".
  107.  
  108.     Once you bring Tcl up and have gotten it to pass all the tests,
  109. try typing "help help" to learn how to use help.
  110.  
  111.     There is also a Tk based help program "tclhelp".
  112.  
  113. MANUAL PAGES
  114. ============
  115.  
  116.     Man pages in nroff/troff format are provided for all of Tcl and
  117. the extensions in the directory tclX7.5a/man.  Start with the
  118. TclX.man manual.
  119.  
  120. EXTENDED TCL VERSION NAMING
  121. ===========================
  122.  
  123.     Extended Tcl takes its version number from the corresponding
  124. version of Berkeley (Ousterhout) Tcl upon which it is based, with
  125. the addition of a trailing letter in case there are multiple
  126. releases of Extended Tcl within a single release of Berkeley Tcl.
  127. This release is TclX 7.5a.
  128.  
  129. INTERFACING TCL AND C++
  130. =======================
  131.  
  132. C++ programmers can include the file "tcl++.h" to define C++ classes
  133. that can be used to access a Tcl interpreter.  This is based on Tcl
  134. C++ classes originally developed by Parag Patel.  The files
  135.  
  136.         src/tclXAppInit.c
  137. and
  138.         tksrc/tkXAppInit.c
  139.  
  140. will compile under both C and C++.
  141.  
  142. PACKAGE LIBRARIES
  143. =================
  144.  
  145.     Package Libraries are a Tcl source code management tool included
  146. in this release.  Package libraries allow you to group Tcl
  147. procedures into logical bundles and create single files, libraries,
  148. that contain multiple packages.  The package code provides a
  149. low-overhead means of automatically demand-loading a package on the
  150. first attempt to execute one of the procedures defined within it.
  151. As such, package libraries provide a mechanism to accommodate the
  152. creation of Tcl applications and libraries of a substantial size.
  153. The TclX library mechanism is a super-set of the mechanism provided
  154. with standard Tcl.
  155.  
  156. LINKING TCL APPLICATIONS
  157. ========================
  158.  
  159.    To build a TclX based application containing C code, start with
  160. either:
  161.  
  162.         src/tclXAppInit.c for just TclX
  163. or
  164.         src/tkXAppInit.c for TclX & Tk
  165.  
  166. and add your application initialization.  These files contain an application
  167. specific initialization function as well as "main".  There are comments in the
  168. code to guide you.  For example:
  169.  
  170.   cc tclXAppInit.o mystuff.a libtclx.a libtcl.a ${TCLXLIBS} -o myapp
  171.  
  172.   cc tkXAppInit.o mystuff.a libtkx.a libtk.a libtclx.a libtcl.a ${TKXLIBS} \
  173.      -o myapp
  174.  
  175. The *AppInit.c files are also installed in the src directory under the
  176. TclX/TkX master directories.
  177.  
  178. The files tclxlibs.mk and tkxlibs.mk define system libraries that the TclX
  179. configure script thinks you should use for linking programs. These file are
  180. in a format that can be included from a make file.
  181.  
  182. IMPORTANT NOTE:  libtclx.a must be specified on the link command line
  183. before libtcl.a.  If the order is reversed, incorrect command line
  184. parsing code will be used.
  185.  
  186. DYNAMIC LOADING OF TCLX
  187. ========================
  188.  
  189.   Instead of linking a custom application based on the TclX shell, it
  190. is possible to dynamic load it into an application based on another
  191. shell.  
  192.  
  193. SUPPORT FOR EXTENDED TCL
  194. ========================
  195.  
  196.     We are committed to providing continuing support for Extended
  197. Tcl.  Please send questions, bug reports, and bug fixes to:
  198.  
  199.          tcl-project@NeoSoft.com
  200.  
  201. WHERE TO GET IT
  202. ===============
  203.  
  204. Tcl & Tk is available via anonymous ftp from:
  205.  
  206.    ftp.cs.berkeley.edu:/ucb/tcl/[tcl7.5.tar.Z tk4.1.tar.Z]
  207. or
  208.    ftp.neosoft.com:/pub/tcl/distrib/[tcl7.5.tar.gz tk4.1.tar.gz]
  209. or
  210.    ftp.uu.net:languages/tcl/[tcl7.5.tar.Z tk4.1.tar.Z]
  211.  
  212. Extended Tcl 7.5a can be downloaded by anonymous FTP from:
  213.  
  214.    ftp.neosoft.com:/pub/tcl/distrib/tclX7.5a.tar.gz
  215. or
  216.    ftp.aud.alcatel.com:tcl/extensions/tclX7.5a.tar.gz
  217.  
  218. A contributed sources archive resides on ftp.aud.alcatel.com and
  219. is mirrored on ftp.ibp.fr for our friends in Europe.  An Frequently
  220. Asked Questions (FAQ) document exists in this archive.
  221.  
  222. Remember to mail Extended Tcl problems and questions to
  223. tcl-project@NeoSoft.com not Dr. John Ousterhout.
  224.  
  225. THANKS
  226. ======
  227.  
  228.   A big thanks to all of the Extended Tcl users from all over the world
  229. who have helped us debug problems and given us valuable suggestions.
  230. A special thanks to John Ousterhout for Tcl, Tk and all the support he
  231. has given us.
  232.  
  233.  
  234. NEOSOFT TCL CONSULTING
  235. ======================
  236.  
  237.   NeoSoft, co-developers of Extended Tcl, provides commercial Tcl
  238. releases, support, training and consulting.  NeoSoft can be reached 
  239. by sending electronic mail to info@NeoSoft.com or by phoning 
  240. +1 713 968-5800.
  241.